升级步骤

  1. 升级数据库，执行对应文件夹下的sql更新脚本

  2. 下载最新版本，将自己写的业务代码覆盖

  3. 若变更了包名、结构，则更新的时候需要针对git提交记录进行逐条比对、更新

  4. 推荐使用git远程分支合并，若有冲突可手动进行合并（推荐大家业务模块开发在bladex-biz，这样bladex只需跟随主分支更新即可）

  5. 更新完毕后，记得将redis执行flushdb命令

  6. 若修改包名或工程结构，导致无法直接通过git merge合并的同学，请看下方的注意点，不要遗漏～ 否则更新容易出错


升级注意点，请务必确认

1. 新版本对密码进行了二次加密，由前端调用传参需要现将原密码进行md5加密后再进行传递，原密码是admin，所以md5加密后是21232f297a57a5a743894a0e4a801fc3, 所以用接口的时候，原先的密码也需要更改为md5后的字符串


2. 新版本用到了租户增强功能，请把blade.tenant.enhance=true的配置加上，cloud版修改nacos内blade.yaml内的配置，boot版修改application.yml内的配置


3. CacheUtil加上了租户缓存隔离，会每次自动给设置的cacheName加上租户id的前缀，所以@CacheEvict注解就没法移除使用CacheUtil生成的缓存了。相对应的需要用到CacheUtil.clear(cacheName)方法来替换@CacheEvict注解进行租户缓存清除，需要大家花20分钟仔细替换下工程内相关方法。

  • 举个栗子：
/**
 * 修改基本信息
 */
@PostMapping("/update-info")
@CacheEvict(cacheNames = {USER_CACHE}, allEntries = true)
public R updateInfo(@Valid @RequestBody User user) {
   return R.status(userService.updateUserInfo(user));
}

⬇️改为⬇️

/**
 * 修改基本信息
 */
@PostMapping("/update-info")
public R updateInfo(@Valid @RequestBody User user) {
   CacheUtil.clear(USER_CACHE);
   return R.status(userService.updateUserInfo(user));
}

4. Saber核心将avue升级到了2.5.0，有几点需要注意

  • 下拉框自定义dictData的写法有变动，删除了原先的this.$refs.crud.findColumnIndex方法，增加来全局的this.findObject方法，大家需要进行全体替换，具体如下：
const index = this.$refs.crud.findColumnIndex("parentId");
this.option.column[index].dicData = data;

⬇️改为⬇️

let column = this.findObject(this.option.column, "parentId");
column.dicData = data;
  • 由于新版本的方法，会因为初次加载延迟导致组件渲染失败，所以dictData字段的赋值需要从created生命周期放至mounted生命周期
created() {
  this.initData();
},

⬇️改为⬇️

mounted() {
  this.initData();
},

5.新版本修复了懒加载树无法实时更新的问题，有几点需要注意，以dept模块为例

  • 后端方法增加返回字段
  • 单独封装一个用于刷新部门下拉框的接口
  • 新增方法如下注释
  • 修改方法如下注释
  • 删除方法如下注释
  • 批量删除方法如下注释

6.新版本调整了loading与done的顺序，非强迫症可以无视

7.后端配置开启字段由以前部分的enable统一改为enabled

  • 具体提交可以参考如下commit


  • 举个栗子：需要将blade.xss.enable=true 修改为 blade.xss.enabled=true 否则xss将不会生效

8.新版本删除了两个过时的配置

  • xss过滤配置，删除了老版本的blade.xss.url.exclude-patterns，请使用 blade.xss.skip-url代替
  • secure过滤配置，删除了老版本的blade.secure.url.exclude-patterns，请使用 blade.secure.skip-url代替

9.新版本删除了过时的RedisUtil

  • RedisUtil已经过期，存在了很多个版本
  • 2.5.0.RELEASE将其删除，使用BladeRedis代替
  • BladeRedisCache也设置为过期，将在未来2.6.0.RELEASE版本进行删除

10.新版本将docker-maven-plugin 升级为 dockerfile-maven-plugin，有较多变动